****************************************************
  README.TXT for the Linux RS232 Touch Panel Driver
  released date: 2007.8.7
****************************************************


==============
 Introduction
==============
This driver is designed for X Window system of Linux.


================
 Supported List
================
The supported distributions are listed bellow:

   Debian 4.0
   Fedora Core 6, Fedora 7
   openSUSE 10.3
   Ubuntu 7.04


===========
 File List
===========
All files in this package are listed bellow:

   readme.txt               This file which it described what distributions
                            supported, what this package contain and how to
                            install this package by automatically or manually.

   install_Debian4.0        A shell script which automatically install ETouch
                            driver related in Debian 4.0.

   uninstall_Debian4.0      A shell script which automatically remove ETouch
                            driver related in Debian 4.0.

   install_Fedora6          A shell script which automatically install ETouch
                            driver related in Fedora Core 6.

   uninstall_Fedora6        A shell script which automatically remove ETouch
                            driver related in Fedora Core 6.

   install_Fedora7          A shell script which automatically install ETouch
                            driver related in Fedora 7.

   uninstall_Fedora7        A shell script which automatically remove ETouch
                            driver related in Fedora 7.

   install_SUSE10.3         A shell script which automatically install ETouch
                            driver related in openSUSE 10.3.

   uninstall_SUSE10.3       A shell script which automatically remove ETouch
                            driver related in openSUSE 10.3.

   install_Ubuntu7.04       A shell script which automatically install ETouch
                            driver related in Ubuntu 7.04.

   uninstall_Ubuntu7.04     A shell script which automatically remove ETouch
                            driver related in Ubuntu 7.04.

   driver/etouch232_drv.so  The object file of the ETouch driver.

   driver/etouch232_drv.o   The old format object file of the ETouch driver.

   utility/Calibration      A calibration tool which it makes the touch point
                            of panel matched with the cursor on screen. Need to
                            run as a root user account.

   utility/Lift-off         This tool is used to enable the lift-off mode.
                            In the lift-off mode, the click is activated when
                            touch is lifted away from the touch screen. However,
                            it is impossible to drag or draw in this mode.

   utility/Swap             This tool is used to swap touch or lift-off
                            definition which is between left and right mouse
                            buttons.


====================
 Installation Guide
====================
Please follow automatic installation procedures for the supported distributions
as above. If the distribution is not listed in supported list, you can do
manual installation steps. Please make sure your Linux & X Window System is
working properly before the installation. Make sure login as root to do the
installation and calibration. Open a terminal session to do the following
automatic or manual installation steps.

1. Automatic Installation Procedures

   1.0 Make a directory /home/touch_CD by typing:

          mkdir /home/touch_CD

       Copy all related files from CD to "/home/touch_CD" directory

   1.1 Change directory to /home/touch_CD and execute auto-install shell script 
       to install the driver.

          cd /home/touch_CD

          ./install_Debian4.0   (for Debian 4.0)
       or
          ./install_Fedora6	(for Fedora Core 6)
       or
          ./install_Fedora7     (for Fedora 7)
       or
          ./install_SUSE10.3	(for openSUSE 10.3)
       or
          ./install_Ubuntu7.04  (for Ubuntu 7.04)

   1.2 After finishing the installation, you will be asked to reboot the
       computer.

   1.3 After system reboot complete, you have to execute "Calibration" to do the
       calibration for the touch panel.

          cd /usr/local/bin

          ./Calibration

       When you start the calibration program, you will see a circle with cross
       inside displayed at the lower left corner on the screen. You have to
       touch it by your fingertip or the tip of pen. The program will display
       additional two circles with cross inside, please touch them as well.

   1.4 There are three tools "Calibration", "Lift-off" and "Swap" will be put
       into the /usr/local/bin directory.

       The tool "Calibration" which it makes the touch point of panel matched
       with the cursor on screen.

       The tool "Lift-off" which it enables the lift-off mode. In the lift-off
       mode, the click is activated when touch is lifted away from the touch
       screen. However, it is impossible to drag or draw in this mode.

       The tool "Swap" is used to swap touch or lift-off definition which is
       between left and right mouse buttons.

   1.5 In order to access these tools easily, the auto-install shell script will
       create icons onto your Desktop.

2. Manual Installation Steps

   2.0 Make a directory /home/touch_CD by typing:

          mkdir /home/touch_CD

   2.1 Mount the CD and copy all related files to "/home/touch_CD" directory

   2.2 Please create /etc/etandt directory for saving some initial files of
       the touch screen application.

          mkdir /etc/etandt

   2.3 In order to ensure you can return to original configuration, please make
       a copy of configuration file, depend on what operating system you are
       running. The /etc/X11/xorg.conf is used by system if you are running
       Debian 4.0, Fedora Core 6, Fedora 7, openSUSE 10.3 or Ubuntu 7.04.
       Otherwise, you have to find out the configuration file which is used by
       operating system you are running.

          cp /etc/X11/xorg.conf  /etc/X11/xorg.conf.bak.touch

   2.4 Use editor, for example the vi, to add strings to /etc/X11/xorg.conf.

       2.4.1 Find "ServerLayout" section, add the following entry:

             Section "ServerLayout"
             	InputDevice "ETouch232" "SendCoreEvents"
             EndSection

       2.4.2 Find the path of hiddev0 description file to add the following
             entry:

             For example, in Fedora Core 6 and openSUSE 10.3:

             Section "InputDevice"
             	Identifier  "ETouch232"
                Driver      "etouch232"
                Option      "Device" "/dev/ttyS0"
             EndSection

       2.4.4 Save changes to the configuration file and exit the editor.

   2.5 Copy the ETouch_drv.so file from /home/touch_CD/driver to the directory
       that it stores the module object files of X server. You can refer to the
       X server log file.

       2.5.1 For example, in Fedora Core 6:

             cp /home/touch_CD/obj/etouch232_drv.so /usr/lib/xorg/modules/input

       2.5.2 If you are running Fedora Core 6 or Fedora 7, please check the
             state of SELinux by referring the /etc/selinux/config file. If
             SELinux is enabled on your system, you must change security context
             of ETouch_drv.so file. Or else the driver couldn't be loaded
             successfully while X server starting.

             chcon -t textrel_shlib_t /usr/lib/xorg/modules/input/etouch232_drv.so

   2.6 Copy three tools "Calibration", "Lift-off" and "Swap" to the directory
       /usr/bin. Their functionality was described in file list. In order to
       access them conveniently, you can copy them to your Desktop.

   2.7 Make sure to plug the touch controller into USB port before reboot the
       computer.

   2.8 When first time start X Window, the touch controller may be not
       accurately matched to the screen, please execute
       /usr/local/bin/Calibration to calibrate the touch screen:

          cd /usr/local/bin

          ./Calibration

   2.9 Please don't use virtual desktop environment with touch screen, due to
       it will not accurately for calibration.


======
 Note
======
1. Please pay attention with Uppercase and Lowercase on above command examples,
   Linux commands are case-sensitive.

2. If you still have problem with the driver installation, please type

      startx &> startx.out

   This will create startx.out with some debug information. Please send back
   the start.out log to us for trouble-shooting.
